home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / dev / e / JRH_RKRM_1.readme < prev    next >
Encoding:
Text File  |  1995-04-27  |  15.0 KB  |  198 lines
  1. Short:    E versions of RKRM examples (Part One)
  2. Author:   m88jrh@ecs.ox.ac.uk (Jason R. Hulance)
  3. Uploader: m88jrh@ecs.ox.ac.uk (Jason R. Hulance)
  4. Type:     dev/e
  5.  
  6. JRH's RKRM Examples (Part One)
  7. ==============================
  8.  
  9. This archive contains translations of all the examples from the following
  10. chapters of the RKRM (Libraries): ASL, Commodities, Exec, GadTools,
  11. Intuition, Preferences and Workbench.  Also included are translations of
  12. all the Resource examples from the RKRM (Devices).
  13.  
  14. The examples retain most of the original comments, with comments specific to
  15. these E versions beginning "-> E-Note:".  A lot of effort has been put into
  16. showing how to effectively use E features such as exceptions and lists.
  17. A number of bugs in the original examples have also been eliminated.
  18.  
  19. If you are new to E you should pay special attention to the effect of using
  20. exceptions: error handling is and clean-up is neatly separated from the main
  21. code, and the code is generally much less indented.  You should also notice
  22. the special care taken to initialise variables appropriately so that
  23. clean-up is made much more simple in the handlers.
  24.  
  25. If you wish to recompile the sources (I expect you might...), you will need
  26. my Typed Modules (V40), my AmigaLib modules and my Useful modules.  These
  27. archives should all be available where you found this archive (Aminet? In
  28. 'dev/e'?).
  29.  
  30. These executables, E sources and E modules are all Copyright (C) 1995,
  31. Jason R. Hulance.
  32. The original RKRM examples are Copyright (C) 1992, Commodore-Amiga Inc.
  33.  
  34. You are free to use the files in this archive to help create your own
  35. programs (whether they are freeware or commercial), but if you wish to
  36. distribute any part of this archive you must include it all, unmodified,
  37. and with this file.
  38.  
  39. (Hopefully, there will be a Part Two which will contain the remainder of the
  40. RKRM examples.)
  41.  
  42.  
  43. ============================= Archive contents =============================
  44.  
  45. Original  Packed Ratio    Date     Time    Name
  46. -------- ------- ----- --------- --------  -------------
  47.     1856     933 49.7% 08-Apr-95 13:30:00  JRH-RKRM-PartOne.readme
  48.     3236    1817 43.8% 08-Apr-95 13:21:58  JRH-RKRM-PartOne/ASL/filehook
  49.     3534    1444 59.1% 05-Apr-95 18:14:36  JRH-RKRM-PartOne/ASL/filehook.e
  50.     1928    1222 36.6% 08-Apr-95 13:21:58  JRH-RKRM-PartOne/ASL/filepat
  51.     3068    1267 58.7% 27-Mar-95 19:44:10  JRH-RKRM-PartOne/ASL/filepat.e
  52.     1540    1054 31.5% 08-Apr-95 13:21:58  JRH-RKRM-PartOne/ASL/filereq
  53.     1560     686 56.0% 27-Mar-95 19:45:06  JRH-RKRM-PartOne/ASL/filereq.e
  54.     1632    1086 33.4% 08-Apr-95 13:21:58  JRH-RKRM-PartOne/ASL/fontreq
  55.     2261    1046 53.7% 27-Mar-95 20:01:20  JRH-RKRM-PartOne/ASL/fontreq.e
  56.     1852    1156 37.5% 08-Apr-95 13:21:58  JRH-RKRM-PartOne/Commodities/broker
  57.     3997    1619 59.4% 01-Apr-95 20:30:20  JRH-RKRM-PartOne/Commodities/broker.e
  58.     4772    2411 49.4% 08-Apr-95 13:21:58  JRH-RKRM-PartOne/Commodities/divert
  59.     5979    2418 59.5% 08-Apr-95 12:35:40  JRH-RKRM-PartOne/Commodities/divert.e
  60.     3732    2085 44.1% 08-Apr-95 13:21:58  JRH-RKRM-PartOne/Commodities/hotkey
  61.     6555    2501 61.8% 01-Apr-95 20:58:02  JRH-RKRM-PartOne/Commodities/HotKey.e
  62.     5684    2832 50.1% 08-Apr-95 13:21:58  JRH-RKRM-PartOne/Commodities/popshell
  63.     5664    2176 61.5% 01-Apr-95 20:04:04  JRH-RKRM-PartOne/Commodities/PopShell.e
  64.     2484    1381 44.4% 08-Apr-95 13:22:06  JRH-RKRM-PartOne/Exec_Library/DeviceIO/deviceuse
  65.     3669    1480 59.6% 31-Mar-95 19:05:16  JRH-RKRM-PartOne/Exec_Library/DeviceIO/deviceuse.e
  66.     3804    2013 47.0% 08-Apr-95 13:22:06  JRH-RKRM-PartOne/Exec_Library/Interrupts/rbf
  67.     4866    2015 58.5% 05-Apr-95 20:00:56  JRH-RKRM-PartOne/Exec_Library/Interrupts/rbf.e
  68.     3352    1772 47.1% 08-Apr-95 13:22:06  JRH-RKRM-PartOne/Exec_Library/Interrupts/timersoftint
  69.     4393    1895 56.8% 05-Apr-95 19:10:44  JRH-RKRM-PartOne/Exec_Library/Interrupts/timersoftint.e
  70.     2500    1392 44.3% 08-Apr-95 13:22:06  JRH-RKRM-PartOne/Exec_Library/Interrupts/vertb
  71.     2160    1064 50.7% 05-Apr-95 19:21:52  JRH-RKRM-PartOne/Exec_Library/Interrupts/vertb.e
  72.     1956    1255 35.8% 08-Apr-95 13:22:06  JRH-RKRM-PartOne/Exec_Library/Lists/buildlist
  73.     2740    1123 59.0% 01-Apr-95 10:58:38  JRH-RKRM-PartOne/Exec_Library/Lists/buildlist.e
  74.     1536    1023 33.3% 08-Apr-95 13:22:06  JRH-RKRM-PartOne/Exec_Library/Memory/allocate
  75.     1015     559 44.9% 31-Mar-95 20:44:36  JRH-RKRM-PartOne/Exec_Library/Memory/allocate.e
  76.      960     674 29.7% 08-Apr-95 13:22:06  JRH-RKRM-PartOne/Exec_Library/Memory/allocentry
  77.     1477     699 52.6% 31-Mar-95 21:16:08  JRH-RKRM-PartOne/Exec_Library/Memory/allocentry.e
  78.     1972    1201 39.0% 08-Apr-95 13:22:06  JRH-RKRM-PartOne/Exec_Library/Ports/port1
  79.     1631     804 50.7% 30-Mar-95 19:43:48  JRH-RKRM-PartOne/Exec_Library/Ports/port1.e
  80.     2056    1238 39.7% 08-Apr-95 13:22:06  JRH-RKRM-PartOne/Exec_Library/Ports/port2
  81.     2420    1157 52.1% 30-Mar-95 19:45:12  JRH-RKRM-PartOne/Exec_Library/Ports/port2.e
  82.      548     411 25.0% 08-Apr-95 13:22:06  JRH-RKRM-PartOne/Exec_Library/Semaphores/semaphore
  83.      290     153 47.2% 31-Mar-95 20:32:32  JRH-RKRM-PartOne/Exec_Library/Semaphores/semaphore.e
  84.     3336    1806 45.8% 08-Apr-95 13:22:08  JRH-RKRM-PartOne/Exec_Library/Signals/signals
  85.     2349    1063 54.7% 08-Apr-95 12:35:22  JRH-RKRM-PartOne/Exec_Library/Signals/signals.e
  86.     3144    1745 44.4% 08-Apr-95 13:22:08  JRH-RKRM-PartOne/Exec_Library/Tasks/simpletask
  87.     1795     900 49.8% 08-Apr-95 12:34:08  JRH-RKRM-PartOne/Exec_Library/Tasks/simpletask.e
  88.     2028    1314 35.2% 08-Apr-95 13:22:08  JRH-RKRM-PartOne/Exec_Library/Tasks/tasklist
  89.     2919    1242 57.4% 01-Apr-95 10:59:02  JRH-RKRM-PartOne/Exec_Library/Tasks/tasklist.e
  90.      920     688 25.2% 08-Apr-95 13:22:08  JRH-RKRM-PartOne/Exec_Library/Tasks/trap
  91.     1369     654 52.2% 31-Mar-95 20:26:18  JRH-RKRM-PartOne/Exec_Library/Tasks/trap.e
  92.     4724    2225 52.9% 08-Apr-95 13:21:58  JRH-RKRM-PartOne/GadTools/gadtoolsgadgets
  93.    11249    3608 67.9% 31-Mar-95 18:19:00  JRH-RKRM-PartOne/GadTools/gadtoolsgadgets.e
  94.     2372    1355 42.8% 08-Apr-95 13:21:58  JRH-RKRM-PartOne/GadTools/gadtoolsmenu
  95.     3849    1324 65.6% 26-Mar-95 16:28:32  JRH-RKRM-PartOne/GadTools/gadtoolsmenu.e
  96.     2228    1335 40.0% 08-Apr-95 13:21:58  JRH-RKRM-PartOne/GadTools/simplegtgadget
  97.     3794    1531 59.6% 26-Mar-95 18:08:34  JRH-RKRM-PartOne/GadTools/simplegtgadget.e
  98.     6024    2548 57.7% 08-Apr-95 13:22:08  JRH-RKRM-PartOne/Intuition/Boopsi/rkmbutclass
  99.    11813    3977 66.3% 31-Mar-95 18:41:46  JRH-RKRM-PartOne/Intuition/Boopsi/rkmbutclass.e
  100.     6626    2336 64.7% 31-Mar-95 18:39:04  JRH-RKRM-PartOne/Intuition/Boopsi/rkmmodel.e
  101.     1514     758 49.9% 08-Apr-95 13:22:08  JRH-RKRM-PartOne/Intuition/Boopsi/rkmmodel.m
  102.     1820    1114 38.7% 08-Apr-95 13:22:08  JRH-RKRM-PartOne/Intuition/Boopsi/talk2boopsi
  103.     4959    1779 64.1% 31-Mar-95 18:16:32  JRH-RKRM-PartOne/Intuition/Boopsi/talk2boopsi.e
  104.     5988    2409 59.7% 08-Apr-95 13:22:08  JRH-RKRM-PartOne/Intuition/Boopsi/userkmmodel
  105.     7065    1815 74.3% 26-Mar-95 20:54:04  JRH-RKRM-PartOne/Intuition/Boopsi/userkmmodel.e
  106.     1596    1056 33.8% 08-Apr-95 13:22:08  JRH-RKRM-PartOne/Intuition/Gadgets/simplegad
  107.     2690    1152 57.1% 26-Mar-95 16:35:54  JRH-RKRM-PartOne/Intuition/Gadgets/simplegad.e
  108.     3304    1833 44.5% 08-Apr-95 13:22:08  JRH-RKRM-PartOne/Intuition/Gadgets/strhooks
  109.     7295    2781 61.8% 26-Mar-95 16:36:44  JRH-RKRM-PartOne/Intuition/Gadgets/strhooks.e
  110.     2168    1444 33.3% 08-Apr-95 13:22:08  JRH-RKRM-PartOne/Intuition/Gadgets/updatestrgad
  111.     4658    1982 57.4% 26-Mar-95 16:37:10  JRH-RKRM-PartOne/Intuition/Gadgets/updatestrgad.e
  112.     1732    1014 41.4% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Images_Text/compleximage
  113.     3488    1469 57.8% 26-Mar-95 16:39:26  JRH-RKRM-PartOne/Intuition/Images_Text/compleximage.e
  114.     1456     955 34.4% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Images_Text/intuitext
  115.     2304    1083 52.9% 26-Mar-95 16:39:42  JRH-RKRM-PartOne/Intuition/Images_Text/intuitext.e
  116.     1500     939 37.4% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Images_Text/shadowborder
  117.     2523    1134 55.0% 26-Mar-95 16:40:00  JRH-RKRM-PartOne/Intuition/Images_Text/shadowborder.e
  118.     1380     916 33.6% 08-Apr-95 13:22:08  JRH-RKRM-PartOne/Intuition/Images_Text/simpleimage
  119.     2263    1074 52.5% 26-Mar-95 16:40:32  JRH-RKRM-PartOne/Intuition/Images_Text/simpleimage.e
  120.     1664    1079 35.1% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Intuition_GUI/easyintuition
  121.     4336    1718 60.3% 26-Mar-95 16:41:06  JRH-RKRM-PartOne/Intuition/Intuition_GUI/easyintuition.e
  122.     1464     968 33.8% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Intuition_GUI/easyintuition37
  123.     4072    1491 63.3% 26-Mar-95 16:41:22  JRH-RKRM-PartOne/Intuition/Intuition_GUI/easyintuition37.e
  124.     1899     885 53.3% 08-Mar-95 18:01:22  JRH-RKRM-PartOne/Intuition/IO_Methods/closewindowsafely.e
  125.      258     204 20.9% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/IO_Methods/closewindowsafely.m
  126.     1816    1180 35.0% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/IO_Methods/eventloop
  127.     4752    1731 63.5% 26-Mar-95 16:40:48  JRH-RKRM-PartOne/Intuition/IO_Methods/eventloop.e
  128.     7248    3035 58.1% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Menus/menulayout
  129.    17527    5411 69.1% 26-Mar-95 16:42:04  JRH-RKRM-PartOne/Intuition/Menus/menulayout.e
  130.     2480    1332 46.2% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Menus/simplemenu
  131.     5235    1962 62.5% 26-Mar-95 16:42:24  JRH-RKRM-PartOne/Intuition/Menus/simplemenu.e
  132.     1404     959 31.6% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Mouse_Keyboard/custompointer
  133.     2285    1016 55.5% 26-Mar-95 16:42:48  JRH-RKRM-PartOne/Intuition/Mouse_Keyboard/custompointer.e
  134.     3080    1704 44.6% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Mouse_Keyboard/mousetest
  135.     6071    2380 60.7% 26-Mar-95 16:43:06  JRH-RKRM-PartOne/Intuition/Mouse_Keyboard/mousetest.e
  136.     3420    1958 42.7% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Mouse_Keyboard/rawkey
  137.     6180    2475 59.9% 26-Mar-95 16:43:20  JRH-RKRM-PartOne/Intuition/Mouse_Keyboard/rawkey.e
  138.     1748    1159 33.6% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Requesters_Alerts/blockinput
  139.     3755    1570 58.1% 26-Mar-95 20:49:48  JRH-RKRM-PartOne/Intuition/Requesters_Alerts/blockinput.e
  140.      840     633 24.6% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Requesters_Alerts/displayalert
  141.     1072     600 44.0% 08-Mar-95 18:49:04  JRH-RKRM-PartOne/Intuition/Requesters_Alerts/displayalert.e
  142.     1052     756 28.1% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Requesters_Alerts/easyrequest
  143.     1560     719 53.9% 26-Mar-95 16:44:24  JRH-RKRM-PartOne/Intuition/Requesters_Alerts/easyrequest.e
  144.     2172    1374 36.7% 08-Apr-95 13:22:12  JRH-RKRM-PartOne/Intuition/Screens/clonescreen
  145.     5314    1875 64.7% 26-Mar-95 16:45:50  JRH-RKRM-PartOne/Intuition/Screens/clonescreen.e
  146.     2448    1368 44.1% 08-Apr-95 13:22:12  JRH-RKRM-PartOne/Intuition/Screens/doublebuffer
  147.     5697    2050 64.0% 26-Mar-95 16:46:38  JRH-RKRM-PartOne/Intuition/Screens/doublebuffer.e
  148.     2704    1542 42.9% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Screens/dualplayfield
  149.     5187    1946 62.4% 26-Mar-95 16:47:00  JRH-RKRM-PartOne/Intuition/Screens/dualplayfield.e
  150.     1048     776 25.9% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Screens/newlookscreen
  151.     1768     851 51.8% 26-Mar-95 16:47:22  JRH-RKRM-PartOne/Intuition/Screens/newlookscreen.e
  152.     1300     874 32.7% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Screens/publicscreen
  153.     2854    1097 61.5% 26-Mar-95 16:47:40  JRH-RKRM-PartOne/Intuition/Screens/publicscreen.e
  154.      604     460 23.8% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Screens/pubscreenbeep
  155.     1211     615 49.2% 08-Mar-95 19:11:42  JRH-RKRM-PartOne/Intuition/Screens/pubscreenbeep.e
  156.     1084     790 27.1% 08-Apr-95 13:22:10  JRH-RKRM-PartOne/Intuition/Screens/screen34to37
  157.     2174    1030 52.6% 26-Mar-95 16:48:08  JRH-RKRM-PartOne/Intuition/Screens/screen34to37.e
  158.     1132     596 47.3% 08-Apr-95 13:22:12  JRH-RKRM-PartOne/Intuition/Special/remembertest
  159.     3532    1110 68.5% 08-Mar-95 19:15:48  JRH-RKRM-PartOne/Intuition/Special/remembertest.e
  160.     4720    2449 48.1% 08-Apr-95 13:22:12  JRH-RKRM-PartOne/Intuition/Windows/lines
  161.    10854    4016 62.9% 31-Mar-95 18:12:38  JRH-RKRM-PartOne/Intuition/Windows/lines.e
  162.     1144     834 27.0% 08-Apr-95 13:22:12  JRH-RKRM-PartOne/Intuition/Windows/openwindowtags
  163.     1544     742 51.9% 26-Mar-95 16:49:38  JRH-RKRM-PartOne/Intuition/Windows/openwindowtags.e
  164.     1756    1140 35.0% 08-Apr-95 13:22:12  JRH-RKRM-PartOne/Intuition/Windows/visiblewindow
  165.     4543    1838 59.5% 26-Mar-95 16:50:02  JRH-RKRM-PartOne/Intuition/Windows/visiblewindow.e
  166.     1372     950 30.7% 08-Apr-95 13:22:12  JRH-RKRM-PartOne/Intuition/Windows/winpubscreen
  167.     2255     904 59.9% 26-Mar-95 16:50:28  JRH-RKRM-PartOne/Intuition/Windows/winpubscreen.e
  168.     1828    1251 31.5% 08-Apr-95 13:21:58  JRH-RKRM-PartOne/Preferences/prefnotify
  169.     1703     828 51.3% 26-Mar-95 16:51:16  JRH-RKRM-PartOne/Preferences/prefnotify.e
  170.     3516    1817 48.3% 08-Apr-95 13:21:58  JRH-RKRM-PartOne/Preferences/showprefs
  171.     5111    1698 66.7% 26-Mar-95 16:51:58  JRH-RKRM-PartOne/Preferences/showprefs.e
  172.     1232     850 31.0% 08-Apr-95 13:22:00  JRH-RKRM-PartOne/Resources/allocate_misc
  173.     1558     731 53.0% 02-Apr-95 16:36:12  JRH-RKRM-PartOne/Resources/Allocate_Misc.e
  174.     3752    1874 50.0% 08-Apr-95 13:22:00  JRH-RKRM-PartOne/Resources/cia_interval
  175.     8803    3023 65.6% 05-Apr-95 20:15:46  JRH-RKRM-PartOne/Resources/CIA_interval.e
  176.     1208     814 32.6% 08-Apr-95 13:22:00  JRH-RKRM-PartOne/Resources/get_disk_unit_id
  177.      752     429 42.9% 02-Apr-95 16:36:24  JRH-RKRM-PartOne/Resources/Get_Disk_Unit_ID.e
  178.     1192     818 31.3% 08-Apr-95 13:22:00  JRH-RKRM-PartOne/Resources/get_filesys
  179.     1361     676 50.3% 08-Apr-95 12:38:12  JRH-RKRM-PartOne/Resources/Get_Filesys.e
  180.     2372    1381 41.7% 08-Apr-95 13:22:00  JRH-RKRM-PartOne/Resources/query_serial
  181.     1713     809 52.7% 02-Apr-95 14:26:54  JRH-RKRM-PartOne/Resources/Query_Serial.e
  182.     1912    1220 36.1% 08-Apr-95 13:22:00  JRH-RKRM-PartOne/Resources/read_battclock
  183.     2079     979 52.9% 02-Apr-95 15:51:10  JRH-RKRM-PartOne/Resources/Read_BattClock.e
  184.     1500    1042 30.5% 08-Apr-95 13:22:00  JRH-RKRM-PartOne/Resources/read_potinp
  185.     1972    1029 47.8% 02-Apr-95 15:08:44  JRH-RKRM-PartOne/Resources/Read_Potinp.e
  186.     1940    1208 37.7% 08-Apr-95 13:22:00  JRH-RKRM-PartOne/Workbench/appicon
  187.     2870    1215 57.6% 26-Mar-95 16:52:52  JRH-RKRM-PartOne/Workbench/appicon.e
  188.     1748    1156 33.8% 08-Apr-95 13:22:00  JRH-RKRM-PartOne/Workbench/appmenuitem
  189.     2631    1187 54.8% 26-Mar-95 16:53:22  JRH-RKRM-PartOne/Workbench/appmenuitem.e
  190.     1932    1224 36.6% 08-Apr-95 13:22:00  JRH-RKRM-PartOne/Workbench/appwindow
  191.     2692    1086 59.6% 26-Mar-95 16:53:40  JRH-RKRM-PartOne/Workbench/appwindow.e
  192.     3580    2014 43.7% 08-Apr-95 13:22:00  JRH-RKRM-PartOne/Workbench/iconexample
  193.     7577    2675 64.6% 26-Mar-95 16:54:06  JRH-RKRM-PartOne/Workbench/iconexample.e
  194.     1860    1128 39.3% 08-Apr-95 13:22:00  JRH-RKRM-PartOne/Workbench/prargs
  195.     2139     920 56.9% 30-Mar-95 18:50:10  JRH-RKRM-PartOne/Workbench/prargs.e
  196. -------- ------- ----- --------- --------
  197.   461089  210654 54.3% 11-Apr-95 23:49:20   149 files
  198.